
  HelpChat Server 12 升级到 13 步骤（Linux）
=============================================

  ⚠ 升级前请先停止 Server 12，并备份整个 HelpChat Server 12 目录。

  以下步骤假设：

    12 服务端目录：/opt/HelpChatServer12/
    13 服务端目录：/opt/HelpChatServer13/

  请根据你的实际安装路径替换。


一、迁移聊天数据
--------------------------------------
  将 12 的数据目录复制到 13：

    cp -r /opt/HelpChatServer12/imdata/data /opt/HelpChatServer13/imdata/


二、迁移头像文件
--------------------------------------
  将 12 的头像目录复制到 13：

    cp -r /opt/HelpChatServer12/public/groups /opt/HelpChatServer13/public/
    cp -r /opt/HelpChatServer12/public/users  /opt/HelpChatServer13/public/

  或者 12 的早期版本是以下目录：

    cp -r /opt/HelpChatServer12/imdata/group /opt/HelpChatServer13/public/
    cp -r /opt/HelpChatServer12/imdata/user  /opt/HelpChatServer13/public/
	
	
三、修复头像文件扩展名
--------------------------------------
  版本 12 头像文件没有扩展名，版本 13 要求 .png 扩展名。

  分别进入以下两个目录，赋予执行权限并运行脚本：

    cd /opt/HelpChatServer13/public/groups/ && chmod +x add_png_ext.sh && ./add_png_ext.sh
    cd /opt/HelpChatServer13/public/users/  && chmod +x add_png_ext.sh && ./add_png_ext.sh

  脚本会自动为无扩展名的文件添加 .png，已有 .png 的不受影响。


四、迁移服务器 ID
--------------------------------------
  打开 12 的配置：/opt/HelpChatServer12/config/serverid.dat
  填入 13 的配置：/opt/HelpChatServer13/config/helpchatsvr.ini

  对应关系：

    serverid.dat          helpchatsvr.ini [server]
    ──────────────        ──────────────────────
    id=xxx            →   id_office  = xxx
    idex=xxx          →   id_market  = xxx

  ⚠ 服务器 ID 必须与 12 一致，否则客户端无法识别服务器。


五、迁移数据库配置
--------------------------------------
  打开 12 的配置：/opt/HelpChatServer12/config/mysql.ini
  填入 13 的配置：/opt/HelpChatServer13/config/helpchatsvr.ini

  对应关系：

    mysql.ini             helpchatsvr.ini [database]
    ──────────────        ──────────────────────
    host=xxx          →   host       = xxx
    port=xxx          →   port       = xxx
    user=xxx          →   user       = xxx
    pswd=xxx          →   password   = xxx
    db=xxx            →   db_office  = xxx
    dbex=xxx          →   db_market  = xxx
    charset=xxx       →   charset    = xxx
    runmode=xxx       →   run_mode       = xxx  （在 [runtime] 段）
    threads=xxx       →   worker_threads = xxx  （在 [runtime] 段）

  ⚠ 注意将 [database] 段的 type 从 sqlite 改为 mysql。


六、启动验证
--------------------------------------
  1. 启动 HelpChat Server 13
  2. 客户端登录，确认账号和历史消息正常
  3. 确认群组和用户头像显示正常


注意事项
--------------------------------------
  · 13 会将数据库中所有名为 order 的字段重命名为 rorder，此变更不可逆，
    12 将无法再读取被 13 升级过的数据表。请务必在升级前备份 12 的数据库。

  · 13 使用的端口与 12 相同，启动 13 前务必确认 12 的 HelpChat Server 服务已完全停止，
    否则会出现端口冲突导致启动失败。

  · 如果 13 继续使用 12 的 MySQL 数据库，停止 12 的 HelpChat Server 服务时，
    请确保 MySQL 服务保持运行中。


建议
--------------------------------------
  · 如果是全新部署，建议安装 MySQL 8.0 或 MariaDB 10.6+ 作为数据库，
    相比 12 中默认的 MySQL 5.7，性能和稳定性都有显著提升。

  · 如果在线人数在 50 人左右，可以直接使用 SQLite，无需安装任何数据库，
    开箱即用，零配置。
